home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / FIRST.ZIP;1 / FIRSTLIB.TXT < prev   
Encoding:
Text File  |  1993-01-19  |  8.6 KB  |  223 lines
  1. ========================================================================
  2. FIRSTLIB.MDA
  3. ========================================================================
  4.  
  5. ABOUT FIRSTLIB
  6. --------------
  7.  
  8. FIRSTLIB is a Microsoft Access library database designed to make 
  9. designing databases a little easier.
  10.  
  11. FIRSTLIB works like most other library databases in that it is accessible
  12. from any database you are currently using/designing/creating.  Unfortunately,
  13. there is no way to make FIRSTLIB immediately accessible through a menu 
  14. command, so accessing the Form Design tools provided in FIRSTLIB is 
  15. not as clean as, say, creating a new Wizard.
  16.  
  17. To get around this problem, I've included an Autokeys macro that you can
  18. import into any database that you are currently working on.  Once 
  19. imported, if you have FIRSTLIB.MDA correctly installed, you are a
  20. keystroke away from the tools provided.
  21.  
  22.  
  23. DISCLAIMER
  24. ----------
  25.  
  26. FIRSTLIB.MDA is provided "as-is" without warranty of any kind,
  27. either expressed or implied, including byt not limited to the 
  28. warranties of merchantibility and/or fitness for a particular
  29. purpose.  The user assumes the entire risk as to the accuracy
  30. and the use of this Microsoft Access Library Database.
  31.  
  32. FIRSTLIB.MDA may be freely copied and distributed subject to the
  33. following conditions: 1) This document must accompany FIRSTLIB.MDA;
  34. 2) FIRSTLIB.MDA should not be modified in any way; 3) FIRSTLIB.MDA
  35. may not be distributed for profit.
  36.  
  37. FIRSTLIB.MDA is not supported by Microsoft.
  38.  
  39.  
  40. INSTALLATION
  41. ------------
  42.  
  43. To install FIRSTLIB.MDA, open MSACCESS.INI in the Windows directory, and
  44. add the following option:
  45.  
  46. [Libraries]
  47.  
  48.   firstlib.mda=ro
  49.  
  50. If FIRSTLIB is not in your Access directory, you should probably
  51. specify the full path, rather than just the filename.  You must exit and
  52. restart Access for the change to take effect.
  53.  
  54.  
  55. WHAT'S INCLUDED
  56. ---------------
  57.  
  58. There are three main tools that FIRSTLIB provides: A Form Design
  59. tools library, a Macro to Module converter, and an expanded
  60. New Procedure dialog for writing Access Basic Code.  Each of these
  61. three tools can be accessed by running a function in the Immediate
  62. Window, or by pressing a key if you have imported the Autokeys 
  63. macro.  The table below shows how to invoke each of the tools.
  64.  
  65.  
  66. TOOL        FUNCTION NAME       AUTOKEY
  67. ---------
  68. Form Design Tool Palette        flib_OpenFDTools        Shift-F12
  69. Macro to Module Coverter        flib_ConvertMacros      Ctrl-F12
  70. Extended New Procedure Dialog   flib_NewProc            F12
  71.  
  72.  
  73. So, if you want to convert macros to modules, you can go to the
  74. Immediate Window and type:
  75.  
  76.   ? flib_ConvertMacros()
  77.  
  78. or simply hit Ctrl-F12 if you have the Autokeys macro loaded.  (Note
  79. that the Extended New Procedure Dialog is only applicable in a module,
  80. so you must have a module active for this function to work.)
  81.  
  82.  
  83.  
  84. THE TOOL PALETTE
  85. ----------------
  86.  
  87. FD Tools is a collection of form design tools that can be used with
  88. any form.  At present, these tools cannot be used with reports, but
  89. this should change soon.  
  90.  
  91. The tool palette contains 2 rows of 6 tools.  Each has a nifty little
  92. icon, but I can't show those here (since this is a text file).  Instead, 
  93. I will reference each tool by its row and column, in the format R1C1, 
  94. R1C2, etc.
  95.  
  96. R1C1: Sunken Frame
  97. ------------------
  98. This tool will put a sunken rectangle behind *any* control, including
  99. subforms, listboxes, dropdowns, etc.  If you change the size of the
  100. control, and then click the Sunken Frame button again, FIRSTLIB
  101. will find any existing frame and simply resize it.  FIRSTLIB finds
  102. existing rectangles by first looking at the control name for all
  103. rectangles on the form.  If the control name is of the pattern
  104. "FieldNameFrame" and you are trying to frame "FieldName," then
  105. "FieldNameFrame" will be resized.  If no rectangle is found with the
  106. correct name, FIRSTLIB will look for a rectangle that is overlapping
  107. the control in question.  If this search returns no rectangles, then
  108. a new frame is created.
  109.  
  110. R1C2: Shadow Frame
  111. ------------------
  112. This tool follows the same rules as the Sunken Frame tool above, but
  113. it creates a frame that looks like a shadow, very similar to the Wizard
  114. Shadow style.  You can easily switch an exisitng Sunken Frame to a
  115. Shadow Frame and vice versa.
  116.  
  117. R1C3: Size Object
  118. -----------------
  119. This tool brings up the dimensions for an object in TWIPS.  On this
  120. dialog you can change, Top, Bottom, Left, Right, Height, and Width.
  121. In the future, I plan to make the measurement settable, so you could
  122. specify dimensions in twips, inches, and/or centimeters.
  123.  
  124. R1C4: Make Controls Same Size
  125. -----------------------------
  126. Clicking this button will bring up a list of all the controls on the
  127. active form.  You can then select the controls that you wish to apply
  128. this operation to.  Next, simply specify the new height and width for
  129. all of the selected controls and click OK.  The controls will be
  130. resized to the same height and width.  If you leave the height or
  131. width field blank, it will be ignored when sizing the controls.
  132. NOTE: The Unit of Measurement option group has no effect.  All measurements
  133. are still in TWIPS.
  134.  
  135. R1C5: Vertical Alignment Tool
  136. -----------------------------
  137. This tool works much like R1C4 in that a list of controls is brought
  138. up and you are allowed to select the controls you wish to apply the
  139. operation to.  The vertical alignment tool will take each control
  140. you selected, in the order that you selected them, and space them
  141. evenly on the form according to the spacing you have specified.
  142.  
  143. NOTE: There is currently a bug here in that the controls you have
  144. selected are not sorted by the time that they were selected.  I
  145. will fix this soon.
  146.  
  147. R1C6: Horizontal Alignment Tool
  148. -------------------------------
  149. Same as the Vertical Alignment Tool only horizontal.  Great for
  150. simulating datasheets in form view.
  151.  
  152. R2C1-R2C4: Alignment Tools
  153. --------------------------
  154. These four tools are essentially short cuts for the menu options
  155. Align Left, Align Right, Align Top and Align Bottom.
  156.  
  157. R2C5-R2C6: Bring To Front / Send To Back
  158. ----------------------------------------
  159. Another group of short cut buttons for another group of commonly
  160. used menu options.
  161.  
  162.  
  163.  
  164. MACRO TO MODULE CONVERTER
  165. -------------------------
  166.  
  167. When you invoke the Macro to Module Converter, a dialog will appear
  168. that lists all the Macros in the current database.  After selecting
  169. a Macro to convert, you must provide a valid file name.  FIRSTLIB
  170. will write the Basic equivalent to the macro directly to this file.
  171. Once complete, simply load the file into a module as text, and you're
  172. ready to go (almost, see below).
  173.  
  174. All of the conditions that you specified in the Macro will be
  175. converted to "If" statements, and support for "..." is included.
  176. Certain Actions will be converted to the ABC equivalent (like
  177. MsgBox), and others will not be included at all (like AddMenu),
  178. but the majority of actions will be converted to the "DoCmd Action"
  179. format.
  180.  
  181. The dialog provides two options that control the format of the code
  182. that is generated.  The first option, Include Error Handling Code,
  183. will automagically add the appropriate 'On Error' type stuff if
  184. it is checked.  If an error occurs, a MsgBox will give a description
  185. of the problem.
  186.  
  187. The second option, Include Function Names in Error Dialogs, is only
  188. applicable if the first option is checked.  If selected, this second
  189. option will place the title of the function in the title of the MsgBox 
  190. that is shown when an error occurs.
  191.  
  192.  
  193.  
  194. EXTENDED NEW PROCEDURE DIALOG
  195. -----------------------------
  196.  
  197. When writing basic code, you can quickly add a new procedure by choosing
  198. [Edit] [New Procedure] from the menu.  Unfortunately, this option 
  199. provides relatively simple procedure creation functionality.  
  200.  
  201. The Extended New Procedure dialog allows you to specify not only the
  202. name and type of the procedure to add, but also the return value
  203. (if the procedure is a function) and comments (if you wish).
  204.  
  205. Furthermore, FIRSTLIB can also automatically generate error handling
  206. code as described in the previous section.
  207.  
  208. Once you've described the function that you wish to create, click the
  209. OK button and the function will be created in the currently active
  210. module.  Note that FIRSTLIB uses SendKeys to create the function, so
  211. if you provide a duplicate function name, disaster could be the result.
  212. For the most part however, functions should be added quickly and
  213. cleanly.
  214.  
  215.  
  216.  
  217. QUESTIONS/COMMENTS
  218. ------------------
  219.  
  220. If you have questions or comments about FIRSTLIB, please contact
  221. me directly through EMail: andrewm@microsoft.com.
  222.  
  223.